home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / util / cli / LibMon.lha / LibMon.doc < prev    next >
Text File  |  1996-12-09  |  4KB  |  118 lines
  1.  
  2.         Library Monitor v1.25
  3.         Copyright © Karl J. Ots
  4.         December 1996
  5.         
  6.         Karl J. Ots
  7.         2/262 Barkly Street
  8.         North Fitzroy, Victoria, 3068
  9.                 Australia.
  10.         
  11.         email:    fstckjo@lux.latrobe.edu.au
  12.     
  13.     THIS PROGRAM IS MAILWARE!  SEND ME AN E-MAIL OR A POSTCARD
  14.     (Really, I mean it!  Send me a postcard!  Please?)
  15.     
  16. NOTE:
  17.     Read the History.txt file for a summary on new features.
  18.  
  19. Disclaimer:
  20.     This program is provided "As Is", with no warrenty, expressed
  21.     or implied.  The author is in no way responible for any problems
  22.     this program may cause to either your system or your health. 
  23.  
  24.     The author is trying to make this program as stable and usable as
  25.     possible, so send him (I mean me) reports of any problams you have.
  26.  
  27.     This program is © Copyright.  You are free to use and distribute
  28.     it, provided these documents and the source code accompany it at 
  29.     all times.  You are free to use concepts present in the source 
  30.     code for any non-profit purpose, short of recompiling and 
  31.     the program with your name on it.
  32.     
  33.     I am open to suggestions on how to make this a better program.
  34.     Send all suggestions to either of my addresses above.
  35.     
  36.  
  37. Library Manager / Monitor:
  38.     You may have noticed the name change.  I found another Amiga
  39.     program called LibMan (on Aminet:util/libs), one that I did 
  40.     not write.  So I changed the name to LibMon.
  41.  
  42.  
  43. What Is LibMon?
  44.     Not so long ago, I was getting into programming in a big way.  I
  45.     quite enjoy living off the thought "If a program doesn't do what
  46.     you want it to, write one that does!".  In particular, I had
  47.     problems when it came to using libraries.  I have so many of
  48.     them that I can't fit all onto one floppy, much less one that has
  49.     to share it's space with other software. my problems came to a head
  50.     when I got the AmigaGuide software.  Where was I going to fit a 
  51.     60K library.  In frustration, I wrote a short and dirty assembly
  52.     language program that opended and closed a specified library, thus
  53.     loading it into memory.  It worked.
  54.     
  55.     LibMon is the decendent of that program, incorperating many ideas
  56.     that I had but couldn't do in assembly.  Previouse versions (LibMan)
  57.     were written in E.  Although a good language, it's not really
  58.     suitable for systems programming, so I've ported it into C.
  59.     
  60.     The compiler I've used is DICE v2.06.37 (Freeware), but I havn't
  61.     used any compliler-specific code, so it should re-compile on any
  62.     ANSI compiler (gcc, vbcc, etc), but I havn't tried it (some 
  63.     feedback in this area would be nice).  This change came about 
  64.     because the old versions were crashing high end 4000s.  Hopefully, 
  65.     this one wont!
  66.  
  67. Description:
  68.     Phew! Now, exactly what does LibMon do?
  69.     LibMon can load, list or flush libraries.  It can be used
  70.     individually, or applied to all libraries in LIBS: or memory.
  71.     LibMon requires OS2 (v36) or above.
  72.     
  73. Input:
  74.     LibMon uses the ReadArgs template to provide an easy interface.
  75.     The template looks like this:
  76.     
  77.         LIBS=LIBNAMES/M,A=ALL/S,L=LIST/S,F=FLUSH/S
  78.     
  79.     The elements in the template are as follows:
  80.     LIBNAMES:    One or more library names to be affected.
  81.     ALL:        Affects all libraries.
  82.     LIST:        List library(s).
  83.     FLUSH:        Flush libraries(s).
  84.     
  85.     The LIST and FLUSH commands are mutually exclusive (cannot be used
  86.     at the same time), as are the LIBNAMES and ALL fields.  An invalid
  87.     combination will cause the Usage message ot be displayed.
  88.  
  89.     This argument chart may come in useful.
  90.     
  91.     Switch        Without LIBNAMES    With LIBNAMES
  92.     DEFAULT        * N/A - Usage        Load LIBNAMES
  93.     ALL        Load All Libraries    * N/A - Usage
  94.     LIST        List All Libraries    List LIBNAMES
  95.     FLUSH        Flush All Libraries    Flush LIBNAMES
  96.     ALL LIST    List All Libraries    * N/N - Usage
  97.     LIST FLUSH    * N/A - Usage        * N/A - Usage
  98.     ALL LIST FLUSH    * N/A - Usage        * N/A - Usage
  99.     
  100. Output:
  101.     There are four different types of output for LibMon:
  102.     
  103.     Usage        Usage information displayed.
  104.     Load and Flush    Both display the name, and the version.revision
  105.             of the libraries.
  106.     List        Displays the name, version.revision, prioity 
  107.             and open count of the libraries.
  108.  
  109. Errors:
  110.     If LibMon can't perform a task, then it will inform you, and
  111.     will continue with the next item, except if LIBS: cannot be
  112.     locked, in which case the program will end (This will not be
  113.     a problem for most people).
  114.  
  115.  
  116.     Well, that's about it.  One final note: You can break (ctrl-c)
  117.     during loading and listing of libraries.  Have fun!
  118.